MacOS/Linux Codex 安装指南

安装前环境准备

  1. 1

    【此步骤在桌面】 下载 Git

    访问 https://git-scm.com/downloads/win， 安装时全都下一步，不要修改路径。

  2. 2

    【此步骤在桌面】 下载 Node.js

    访问 https://nodejs.org/zh-cn/download， 安装时全都下一步，不要修改路径。

安装步骤

  1. ★

    安装 Codex 官方原版包

    $ npm install -g @openai/codex
# 或者
$ brew install codex
  2. 2

    创建目录

    $ rm -rf ~/.codex
$ mkdir ~/.codex
  3. 3

    在“API 密钥”界面配置一个 API Key

    访问仪表板的“API 密钥”页面，创建并复制一个新的 API 密钥。

  4. 4

    创建 auth.json 文件

    删除 ~/.codex 路径下已存在的 auth.json 文件（若有），然后新建一个 auth.json，内容为：

    {
  "OPENAI_API_KEY": "你的 API_KEY"
}
  5. 5

    创建 config.toml 文件

    删除 ~/.codex 路径下已存在的 config.toml 文件（若有），然后新建一个 config.toml，内容直接复制下方配置：

    model_provider = "flu"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.flu]
name = "flu"
base_url = "https://www.fluapi.com/v1"
wire_api = "responses"

重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功：

$ codex -V

开始使用

安装完成后，您可以在任何项目目录中开始使用 Codex。

# 进入你的项目目录
$ cd your-project-folder

# 启动 Codex
$ codex

支持 VSCode 官方插件

完全支持 VSCode 官方插件。